home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Applications / bbeditlinesort1.2b1 / LineSort 1.2b1 / LineSort ReadMe 1.2b1 < prev    next >
Encoding:
Text File  |  1994-11-22  |  5.1 KB  |  156 lines  |  [TEXT/R*ch]
  1. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  2.  
  3. SUMMARY
  4.  
  5.     Linesort -- A BBEdit Extension.
  6.     
  7.     Copyright (c) 1994, Craig H. Maynard.  All rights reserved.
  8.     
  9.     Current Version: 1.2b1
  10.     
  11.     This new extension adds functionality to BBEdit and BBEdit Lite, the
  12.     Macintosh text editors from Bare Bones Software.  LineSort is capable
  13.     of sorting small or large amounts of text with reasonable speed and
  14.     predictable memory requirements.
  15.     
  16.  
  17. FEATURES
  18.  
  19.     -    Sorts selected region of text, adjusting to span complete lines.
  20.     
  21.     -    Offers a choice of standard (ASCII) or international ordering.
  22.     
  23.     -    Capable of ignoring n leading characters, or leading whitespace.
  24.     
  25.     -    Sorts lines in ascending or descending order.
  26.     
  27.     -    Sorts lines in place, or pastes sorted lines into new document.
  28.     
  29.     -    Supports the UNDO command (BBEdit version 3.0 or later).
  30.     
  31.     -    Remembers sorting preferences.
  32.     
  33.     -    Optionally skips dialog, after first sort in current document.
  34.     
  35.     See “Inside Macintosh: Text”, chapter 5, for a complete description 
  36.     of international text comparison.
  37.  
  38.  
  39. INSTALLATION
  40.     
  41.     Install LineSort by placing it in the folder called "BBEdit Extensions",
  42.     which should be located either inside the same folder as BBEdit itself, 
  43.     or inside the Extensions folder of the active System Folder.
  44.     
  45.     
  46. USAGE NOTES
  47.     
  48.     IMPORTANT:  During testing with the commercial version of BBEdit 3.0, we
  49.     encountered a serious memory error that caused the system to crash.
  50.     Upgrading to BBEdit 3.0.1 appeared to fix the problem.  We strongly
  51.     urge BBEdit 3.0 users to upgrade to BBEdit 3.0.1 before using LineSort 1.2.
  52.  
  53.     Use the “Standard” option to sort text at maximum speed.  The
  54.     “International” option is useful if you want to ignore case or other
  55.     secondary characteristics.
  56.     
  57.     LineSort always assumes that the selected text is composed in a single
  58.     script and language.
  59.     
  60.     LineSort tries to allocate a block of additional memory approximately
  61.     the same size as the selected region.     If sufficient memory is
  62.     not available, LineSort displays an alert and returns control to
  63.     BBEdit.
  64.     
  65.     The "Skip Dialog" option is similiar to the BBEdit option key modifier.
  66.     Select this option if you wish to repeatedly sort text within the
  67.     current document, using the same sorting parameters. "Skip Dialog"
  68.     remembers the name of the most recently sorted document, so to turn
  69.     this option off you will need to sort a different document.
  70.     
  71.     If you require additional Macintosh sorting functionality not provided
  72.     by LineSort, we recommend the MPW sort tool.
  73.     
  74.     
  75. USER SUPPORT
  76.     
  77.     This version is a “public beta”; it is substantially feature-complete,
  78.     and does what it says it does. It is in need of real field-testing.  If
  79.     you have a problem using it, or if you run into anomalous behavior,
  80.     please contact us (preferably via e-mail):
  81.  
  82.         Craig H. Maynard
  83.         PO Box 472
  84.         Cupertino, CA 95015
  85.         maynard@apple.com
  86.     
  87.     
  88. DISTRIBUTION
  89.     
  90.     This extension is free software. You may redistribute it under the terms
  91.     of the GNU General Public License as published by the Free Software
  92.     Foundation; either version 2 of the License, or (at your option) any
  93.     later version.
  94.     
  95.     This program is distributed in the hope that it will be useful, but
  96.     WITHOUT ANY WARRANTY; without even the implied warranty of
  97.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  98.     General Public License for more details.
  99.     
  100.     For a copy of the GNU General Public License, write to the Free
  101.     Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, MA 02139,
  102.     USA.
  103.     
  104.     The latest source code for LineSort is available from the developer,
  105.     under terms of the GNU General Public License, section 3.
  106.     
  107.     
  108. MODIFICATION HISTORY
  109.       
  110.     Date        Version     Change
  111.     
  112.     940813    1.0        add dialog item to ignore n leading chars
  113.     940814    1.0        add BBEdit callback version-checking
  114.     940814    1.0        add dialog checkbox to paste sorted lines into new window
  115.     940909    1.0        switch from quicksort to heapsort
  116.     940910    1.0        add BBEdit progress bar 
  117.     
  118.     940921    1.1        About-Box compatible with M68000 Macs
  119.     
  120.     940927    1.2        IUMagIDString() obsolete; now uses IdenticalText()
  121.     940927    1.2        IUMagString() obsolete; now uses CompareText()
  122.     941004    1.2        exclude end-of-line byte during line comparison
  123.     941009    1.2        add option to ignore leading whitespace
  124.     941009    1.2        add option to skip the sort dialog for the current document
  125.     941018    1.2        enable UNDO command (BBEdit version 3.0 or later)
  126.     941021    1.2        add custom progress bar
  127.     
  128.     
  129. RELEASE HISTORY
  130.       
  131.     Date        Version     Site
  132.     
  133.     940914    1.0        Info-Mac
  134.     940921    1.1        Info-Mac
  135.     941023    1.2b1    Info-Mac
  136.     
  137.  
  138. CREDITS AND ACKNOWLEDGMENTS
  139.  
  140.     Sorting algorithm adapted from Korsh & Garrett, "Data Structures,
  141.     Algorithms and Program Style Using C", 1st edition, page 386.
  142.  
  143.     Sorting progress bar implemented using the CModalProgress class by
  144.     Graham Heathcote <heathcot@bnr.ca>.
  145.  
  146.     Some of the text in this document was copied without permission from 
  147.     publications of Bare Bones Software and the Free Software Foundation.
  148.     
  149.     Our thanks to Bare Bones Software <bbsw@netcom.com> for providing an
  150.     excellent interface for writing BBEdit extensions.  Obviously, LineSort
  151.     would not have been possible without this functionality.  Jeepers,
  152.     Richard, we're so impressed!
  153.     
  154.     
  155. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  156.